Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: OpenDoc Programmer's Guide / Part 2 - Programming


Chapter 7 - Storage

This is the fifth of eight chapters that discuss the OpenDoc programming interface in detail. This chapter describes the external storage facilities OpenDoc uses and provides. OpenDoc relies on a system of persistent storage that is built upon the native file-storage facilities of each of the individual OpenDoc platforms. The same fundamental storage concepts and structures are used consistently for document storage and for data transfer (clipboard transfer, drag and drop, and linking, described in the next chapter).

Before reading this chapter, you should be familiar with the concepts presented in Chapter 1, "Introduction to OpenDoc," and Chapter 2, "Development Overview." For additional concepts related to your part editor's runtime environment, see Chapter 11, "OpenDoc Runtime Features."

This chapter introduces the general architecture of the OpenDoc storage system, including how parts are stored, and then describes how your OpenDoc part editor can use that architecture to store and retrieve its own content.


Chapter Contents
The OpenDoc Storage System
Storage Units, Properties, and Values
Storage-Unit Organization
Standard Properties
Creating Properties and Values
Focusing a Storage Unit
Manipulating the Data in a Value
Iterating Through a Storage Unit
Removing Properties and Values
Storage-Unit IDs
Persistent References
Persistent References in OpenDoc
Creating Persistent References
Persistent References and Cloning
Main and Auxiliary Storage Units
Prefocused Access With Storage-Unit Views
Documents, Drafts, and Parts
Drafts
Storage Model for Parts
What a Draft Contains
Info Properties
Container Properties
Creating a New Document
Reading and Writing Your Part
Initializing and Reading a Part From Storage
The somInit Method
The InitPart Method
The InitPartFromStorage Method
Writing a Part to Storage
The Externalize Method
The ExternalizeKinds Method
Creating Additional Storage Units
Storing and Retrieving Display Frames
Storing and Retrieving Embedded Frames
Reading and Writing Part Info
Changing Your Part's Content
Adding an Embedded Part
Removing an Embedded Part
Making Content Changes Known
Closing Your Part
The ReleaseAll Method
The somUninit Method

Previous Book Contents Book Index Next

© Apple Computer, Inc.
16 JUL 1996




Navigation graphic, see text links

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help